home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Amiga Collections: Taifun
/
Taifun 257 (1993-09-10)(Manewaldt, A.)(DE)(PD).zip
/
Taifun 257 (1993-09-10)(Manewaldt, A.)(DE)(PD).adf
/
AKCC
/
AKCC_Docs
/
AKCC_ENG.doc
< prev
next >
Wrap
Text File
|
1993-09-07
|
14KB
|
534 lines
AKCC V2.2.0
- SHAREWARE -
(c) 1990-93 by Andreas R. Kleinert. All rights reserved.
This program was written under OS V3.00 and is therefore
fully compatible. It needs OS >= V1.2.
This program needs 'akcc_gen0.library' V36+ (in "LIBS:").
Release Date : 30.05.1993
Copyright :
===========
The program AKCC V2.2.0 and its documentation files are
(C)opyright 1990-93 by Andreas R. Kleinert. All rights reserved.
The right of using this program is granted to you by paying the
SHAREWARE-fee of 15,00 DM (10 $) to the author.
Disclaimer :
============
The author takes no responsibility for any results of the use of this
program.
This software is provided "AS IS" and there is no warranty of any kind,
so that you use this software at your own risk.
Rights :
========
Registered users - users, which paid the SHAREWARE-fee already -
have the possibility to send the author an empty disk and enough
postage money to receive the newest version of the program.
These users also may receive later versions for enough postage
money and an empty disk, but only as long as the author thinks
that he's able to provide this service, and as long as the development
of the program is continued and no changes have taken place in the
legal status of the program (Freeware, commercial, ...).
The SHAREWARE-fee only corresponds to the current version owned by
the user. All the rest are ADDITIONAL and VOLUNTARY services of
the author.
Disclaimer :
============
Der Autor übernimmt keine Verantwortung für irgendeine Art von Auswir-
kungen, die durch die Nutzung dieses Programmes entstehen.
Diese Software wird zur Verfügung gestellt "WIE SIE IST" und es wird
keine Garantie irgendeiner Art übernommen, so daß Sie diese Software
auf eigenes Risiko nutzen.
Distribution :
==============
The program AKCC V2.2.0 is freely distributable (SHAREWARE).
You may copy it, if the copyright notice is left intact and
all of its parts are included in the distribution.
This program must not be included in commercial packages or commercial
program collections without my written permission.
This program must not be sold in any way, but it is allowed to take
a nominal fee including the costs for copying.
This program may be put on public domain disks or included in public
domain disk libraries.
Special permission hereby goes to Fred Fish's AmigaLib-Disks and
the german series TAIFUN, FRANZ, TIME, GPD and Amiga Szene.
This program may also be distributed via electronic mail and may be
put into mailboxes as long as the redistribution conditions are
respected in all points.
By using or distributing this program you automatically agree to
all of the above conditions and terms.
Function :
==========
AKCC V2.2.0 is a packet of CLI-/Shell-Commands for the Amiga, which
is intended to make working with the AMIGA, especially for experienced
users and programmers, but also beginners, somewhat easier.
AKCC is intended to be additionally used with other existing CLI-/Shell-
Packets (e.g. with those from ARP or Commodore).
There are as well programs which just replace similar ones, as well as
programs, which are completely new.
Installation :
==============
Version A :
1. Use the special Installation program.
(If there do appear problems, which should not happen, use the
'Version B' method ...)
Version B :
1. Copy the (yet) 35 'AKCC' commands into the 'C'-Directory on your
System- or on any other disk.
2. Copy the actual version of the 'akcc_gen0.library' (V36+) into the
'LIBS'-Directory on your System- or on any other disk.
Version C (if you've got a lack of disk-space ...)
1. Just copy the part of the (yet) 35 'AKCC' commands THAT YOU NEED
into the 'C'-Directory on your System- or any other disk.
2. Copy the actual version of the 'akcc_gen0.library' (V36+) into the
'LIBS'-Directory on your System- or on any other disk.
Also :
... create (please) the logical Devices 'T:', 'ENV:' and 'CLIPS:'
(e.g. as follows) !!!
MakeDir RAD:t ; In the startup-sequence :
MakeDir RAD:env ; Set 'FailAt' on a higher level,
MakeDir RAD:clipboards ; if using 'RAD:', because
Assign T: RAD:t ; 'MakeDir' will produce errors
Assign ENV: RAD:env ; after a reset.
Assign ENV: RAD:clipboards ; ('RAD:' is recoverable, as you
; know ...)
For creating 'ENV:' you may (and should) use the AKCC-Command
'EnvAct' instead (if possible) !
... please increase the stack size on a higher level !
It's useful to work with a stack size of at least 30000 Bytes,
which is useful for all programs, which work recursively
(not only Compilers do so !!!).
All of the commands can be made memory-resident with the CLI-Command
'Resident'.
Correspondence :
================
If you like, you may send me some money. Perhaps this will motivate me
to continue programming such programs or just making updates of
this one. Send bug-reports, money or whatever to :
Andreas R. Kleinert,
Grube Hohe Grethe 23,
W-5900 Siegen 1,
Germany.
Usage :
=======
Each single 'AKCC'-Command prints out a short desrciption of itself,
when it is started with a single '?' as its only parameter.
This description always looks like this :
'USAGE : x <x> <x> [...]'
The same thing happens, if a command was used wrong, but only if it has
not been used TOO WRONG ...
Command Summary :
=================
AboutCLI AD *
CheckExec Comment *
DateAct Display
DosRequest Duplic *
EnvAct ExecDevs
ExecIRupts ExecLibs *
ExecMem ExecPorts
ExecRes ExecSems
ExecTasks ExtShow *
FullPath HunkShow
KAssign * Kill *
KillTask * KInfo
KScroller LED
Move * NewDir
NewName PrefSet
PriSet * ProSet *
Show * Texter
WinAct
Commands marked with a '*' support WildCards ('*'/'?'/'#?') and/or the
recursive method of working on directories (option '-a').
Under OS V2.04+ the normal DOS-WildCards are ADDITIONALLY
supported (inclusive WildStar, e.g. "(Hello#?|World*)" ).
A more detailed ListUp :
AboutCLI
-> (gives information about some preferences of the
(current) CLI : Stacksize, Prompt, Path, ...)
AD
-> (changes the current directory. WildCards and Backward-
References possible.)
CheckExec
-> (shows some values of the 'ExecBase' and checks some
vectors to avoid viruses.
Is also able to show Boot-Blocks.
Printer output possible.)
Comment
-> (adds remarks to a file. WildCards.)
DateAct
-> (shows or sets the actual system-time and -date.
Is also able to read/write the Realtime-Clock
MSM 6242 B - e.g. inside the Amiga 500 Plus.)
Display
-> (displays the content of a file on the Screen or
a (virtual) device (e.g. PRT:, CON:, SER:, ...),
or into an other file. Supports octal and hexadecimal
printing and source-code generation.)
Duplic
-> (copies files/dirs.)
EnvAct
-> (is able to manage all affairs with environment-
variables in an easy and quick way.)
ExecLibs
-> (informs about all resident/deletes/loads libraries.)
ExecMem
-> (shows free memory.
The special : Is able to write the result into an
environment variable !!!)
ExecSems
-> (informs about all resident semaphores.)
ExecRes
-> (informs about all resident resources.)
ExecIRupts
-> (informs about all resident interrupts.)
ExecDevs
-> (informs about all resident devices.)
ExecPorts
-> (informs about all resident ports.)
ExecTasks
-> (informs about all active tasks.)
ExtShow
-> (shows a directory, protection bits, date and
comment.
With special functions under OS V2.04.)
FullPath
-> (Sets a completely new list of paths, which have
to be searched for commands.
Parameter is the name of a file, which contains
this list.
As a result of this, the order, in which the paths
have to searched is exactly defined.
Also single paths may be added or removed.)
HunkShow
-> (shows the HUNKS of a program or object-file
and recognizes IFF-files of all kinds, also
other kinds of files.)
KAssign
-> (manages assignments.
With special functions under OS V2.04.)
Kill
-> (deletes files/dirs.)
KillTask
-> (deletes one (or many) task(s) from the system's lists.
With WildCard-Support !!!.)
KInfo
-> (gives Information of all mounted Volumes, e.g. Disks
or RAM-Disks.)
LED
-> (turns the Audio-Filter (PowerLED) on or off.)
Move
-> ('moves' files/dir from one device/dir to an other.
Copies the Source, then deletes it => combination
of 'Kill' and 'Duplic'.)
NewName
-> (renames files/dirs.)
NewDir
-> (creates a new directory or a complete new path :
e.g. 'df0:Texts/Letters/Private'.)
ProSet
-> (sets new protection bits for a file
[from : hsparwed].)
PriSet
-> (changes the priority of a task/process via name-
reference.
WildCards !!!.)
PrefSet
-> (allows to change some of the system's preferences
[e.g. key repeat delay and speed], either via a sim-
ple 'menu' or via command line arguments.)
Show
-> (shows a directory.)
Texter
-> (prints out a text on the screen OR on a parallel
printer.
options : normal, bold, underlined, italic,
reverse, free lines)
All the styles and more things are to control via
codes like those in 'C' (e.g. '\I', '\B', '\C=0,1')
Uses for parallel printing 'PRT:' or, if 'PRT:'
not available, 'PAR:'.)
WinAct
-> (sizes the active window to PAL-, NTSC- or the
biggest possible size, or brings it just to a
wished X/Y-size (everything possible).
Also can move the window into the left, top corner
of the screen or give it a new title.)
Additional Information :
========================
- EnvAct
---> SHOULD be called in the Startup-Sequence / User-StartUp.
e.g. as follows :
EnvAct INIT RAM:
Creates the directory 'RAM:env', assigns it to 'ENV:', and
the environment variables 'AKCC' and 'AKCC-LIB'.
- NewDir
---> NewDir also creates complete paths (recursive), so that con-
structions like 'RAM:tmp/comp/txt/1' etc. are also legal !
One command suffices !
- Texter
---> All the styles are combineable (for the printer as well as for
the screen).
- PrefSet
---> - Be careful by changing the 'KEY...'-values !!!
- Manipulations on the TOPAZ-charset only becomes important, if
a new window is opened.
- KillTask
---> Be careful by killing any tasks/processes (especially
System-Tasks).
Known Bugs :
============
- 'AD' :
Some Shells, like the OS-2.04-Shell, or the 'WShell', which
shows the current directory in the title bar of the window or
in the prompt of the command-line, don't examine the changes
made by 'AD'.
-> Fixing :
WShell :
Don't use the shell, live with it, or
turn its special function off.
OS V2.04 :
Well, in this OS-Version the Command 'CD'
is resident (in ROM), so you don't need
AKCC's 'AD'.
- 'CheckExec FORMAT' :
Does not seem to be fully free of bugs yet. Sorry !
(For KNOWN BUGS of the 'akcc_gen0.library', see 'akcc_gen0.library.doc' !)
History :
=========
V2.2.0 : (30.05.1993)
--------
- improved some commands :
AboutCLI, ExecLibs, ExecDevs, ExecRes, ExecTasks, HunkShow
V2.1.2 :
--------
- improved KillTask (BREAK-Option) and HunkShow.
- Bug-fixes in the akcc_gen0.library (see its doc-file)
[ some releases ]
V2.1.1 :
--------
- use of SAS/C V6.00
- sometimes GREAT code-reduction
- many enhancements and bug-fixes
(ExecDevs, ExecSems, CheckExec, ...)
V2.0.1 :
--------
- Bugs fixed :
- FullPath :
- Now also under OS V2.04 runable bug-free
(because of bug-fix in "akcc_gen0.library).
- especially improved commands :
- ExecDevs : Now same options as ExecLibs.
- AboutCLI : "Optical" improvements.
- AND MORE IMPROVEMENTS
V1.7.1 :
--------
- Bugs fixed :
- ExecRes :
- Known bug hopefully now fixed.
- HunkShow :
- many bugs have been fixed.
- connected (or 'integrated') commands :
Integrated program Former single programs
KAssign (added KAssign-2)
ExtShow (added ExtShow-2)
- especially improved commands :
- Display : Now also creates Assembler- or C-Source out of a File.
("dc.b"-field / BYTE-Array).
- HunkShow : Now also recognizes "RIFF-????"-Files.
- CheckExec : - Is now also able to format disks.
- SAFE check WHICH DiskDrive !
- AND MANY MORE IMPROVEMENTS
V1.6.2 :
--------
- Use of "akcc_gen0.library" V36.7 with more functions.
- Bugs fixed :
- CheckExec,DateAct :
- ExtIO-Structure was not delocated.
- FullPath :
- Heavy bug fixed.
- especially improved commands :
- AboutCLI, CheckExec, ... :
- Output has been improved (less routine-calls).
- Exec... :
- improved Text-Formatting.
(ExecRes : bug fixed.)
- HunkShow : Recognizes much more File-Types.
The routines for recognition have also been improved.
[ Version-History of versions before V1.6.2 is no longer
included. ]
Copyrights :
============
Some of the mentioned names or products above may be copyrighted by
companies or trademarks of companies.